package cn.iocoder.devlop.module.annual.report.shouldknow.service;

import cn.iocoder.devlop.framework.common.pojo.PageResult;
import cn.iocoder.devlop.module.annual.report.shouldknow.controller.vo.ShouldKnowCreateReqVO;
import cn.iocoder.devlop.module.annual.report.shouldknow.controller.vo.ShouldKnowExportReqVO;
import cn.iocoder.devlop.module.annual.report.shouldknow.controller.vo.ShouldKnowPageReqVO;
import cn.iocoder.devlop.module.annual.report.shouldknow.controller.vo.ShouldKnowUpdateReqVO;
import cn.iocoder.devlop.module.annual.report.shouldknow.dal.dataobject.ShouldKnowDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;

/**
 * 填报须知 Service 接口
 *
 * @author sunhao
 */
public interface ShouldKnowService {

    /**
     * 创建填报须知
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createShouldKnow(@Valid ShouldKnowCreateReqVO createReqVO);

    /**
     * 更新填报须知
     *
     * @param updateReqVO 更新信息
     */
    void updateShouldKnow(@Valid ShouldKnowUpdateReqVO updateReqVO);

    /**
     * 删除填报须知
     *
     * @param id 编号
     */
    void deleteShouldKnow(Long id);

    /**
     * 获得填报须知
     *
     * @param enttype 编号
     * @return 填报须知
     */
    ShouldKnowDO getShouldKnow(String enttype);

    /**
     * 获得填报须知
     *
     * @param id 编号
     * @return 填报须知
     */
    ShouldKnowDO getShouldKnow(Long id);

    /**
     * 获得填报须知列表
     *
     * @param ids 编号
     * @return 填报须知列表
     */
    List<ShouldKnowDO> getShouldKnowList(Collection<Long> ids);

    /**
     * 获得填报须知分页
     *
     * @param pageReqVO 分页查询
     * @return 填报须知分页
     */
    PageResult<ShouldKnowDO> getShouldKnowPage(ShouldKnowPageReqVO pageReqVO);

    /**
     * 获得填报须知列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 填报须知列表
     */
    List<ShouldKnowDO> getShouldKnowList(ShouldKnowExportReqVO exportReqVO);

}
